disabled
Type
property
Summary
Specifies that an object is dimmed and does not respond to user action.
Syntax
set the disabled of <object> to {true | false}
Description
Use the disabled property to find out whether a control can respond to mouse clicks or keyboard presses.
Disabled buttons are drawn with gray borders and text to indicate that they cannot be clicked. Controls whose disabled property is true do not trigger messages such as mouseUp or mouseEnter, but they can respond to messages sent with the send command. If a disabled control is on top of an enabled control, the disabled control is transparent to clicks, and clicking sends the appropriate messages to the enabled control underneath.
A disabled control cannot receive the focus.
Setting a group's disabled property sets the disabled of each control in the group.
You can set the disabled property of a menu by specifying the menu's name or number. Menu items in disabled menus are drawn in gray text and cannot be chosen.
The disabled property of an object is the logical inverse of that object's enabled property. When the enabled is true, the disabled is false, and vice versa.
Examples
set the disabled of button "Destroy Everything" to true
set the disabled of menu "View" to true
Related
property: enabled
command: disable, group, enable menu, send
function: menus
glossary: object, property, message, trigger, command, menu item, menu
message: mouseUp, mouseEnter
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile